60493300 



CONTROL DATA 



CYBER COMMON UTILITIES 
REFERENCE MANUAL 



( 



CONTROL DATA® 
CYBER 170 SERIES 
CYBER 70 SERIES 
7600 SERIES 
6000 SERIES 
COMPUTER SYSTEMS 



REVISION RECORD 


REVISION 


DESCRIPTION 


A 


Original release. 


(4-8-75) 




















































































Publication No. 
60493300 





Additional copies of this manual may be 
obtained from the nearest Control Data 
Corporation sales office. 

CYBER Common Utilities 
Reference Manual 

©1975 

Control Data Corporation 

Printed in the United States of America 



Address comments concerning 
this manual to: 

CONTROL DATA CORPORATION 

Publications and Graphics Division 

215 MOFFETT PARK DRIVE 
SUNNYVALE, CALIFORNIA 94086 

or use Comment Sheet in the 
back of this manual 



60493300 A 



LIST OF EFFECTIVE PAGES 



New features, as weU as changes, deletions, and 
additions to information in this manual are indicated 
by bars in the margins or by a dot near the page 
number if the entire page is affected. A bar by the 
page number indicates pagination rather than content 
has changed. 



( 



I 



Feature 



Page 



Cover 


— 


Title Page 


— 


ii thru vii 


A 


1-1 thru 1-3 


A 


2-1 thru 2-6 


A 


3-1 thru 3-7 


A 


A-l, A-2 


A 


B-l.B-2 


A 


Cmt Sheet 


A 


Return Env 


— 


Back Cover 


— 



Revision 



Feature 



Page 



Revision 



60493300 A 



in 



c 



* 



PREFACE 



This publication describes the utilities that operate 
under the following operating systems: 

KRONOS 2.1 for the CONTROL DATA® 
CYBER 70/Model 72, 73, 74, and 6000 Series 
Computer Systems. 

NOS 1.0 for the CONTROL DATA CYBER 
170, CYBER 70/Model 72, 73, 74 and 6000 
Series Computer Systems. 

SCOPE 2.1 for the CONTROL DATA CYBER 

70/Model 76 and 7600 Computer Systems. 

SCOPE 3.4 for the CONTROL DATA CYBER 

70/Model 72, 73, 74, and 6000 Series Com- 
puter Systems. 



The utilities described are: 

COPYL/ Maintains a single binary file. 

COPYLM (Replaces the COPYL utility under 
SCOPE 3.4 and COPYL and 
COPYLM utilities under SCOPE 2.1.) 

ITEMIZE lists information about the contents 
of a binary file or multifile. 



Other utility programs for the above operating 
systems are documented in their respective operating 
system manuals. 

Other documents of interest: 



Publication 
KRONOS 2.1 Reference Manual 
NOS 1.0 Reference Manual 
SCOPE 3.4 Reference Manual 
SCOPE 2.1 Reference Manual 



Publication Number 
60407000 
60435400 
60307200 
60342600 



This product is intended for use only as 
described in this document. Control Data 
cannot be responsible for the proper func- 
tioning of undescribed features or undefined 
parameters. 
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INTRODUCTION 



< 



The terminology used for files and records differs 
somewhat within the different environments of the 
various operating systems. Generally, terms used 
with KRONOS, NOS, and SCOPE 3.4 are similar; 
terms used with SCOPE 2.1 are different, reflecting 
SCOPE 2.1 use of Record Manager within the oper- 
ating system. 

The physical representation of files and records 
differs among operating systems and among different 
devices within the same operating system. The logi- 
cal interpretation of physical entities varies less. The 
CYBER utilities recognize logical structures applicable 
to all the operating systems. 

Terms applicable to this manual and the common 
CYBER utilities are discussed below. For a complete 
discussion of possible file formats, consult the refer- 
ence manuals for the respective operating systems. 



FILE STRUCTURE DEFINITIONS 

A file is that collection of information known to an 
operating system by a logical file name. A file begins 
at beginning-of-information and ends at end-of- 

; n 4V.,^n n +; n « \T~ ..„.*.. :~C .„+: — — :„*„ — j.„:j„ j.1 

liuuiiiianuii. nu lwci iinuuiiaui'ii cju&U) uuiuuc uncac 

boundaries. 

A division smaller than beginning-of-information to 
end-of-information is known by several different 
names, depending on the operating system. 

Under SCOPE 2.1, information between beginning-of- 
information and end-of-information can be divided 
into partitions which, in turn, can be divided into 
sections. The term record is restricted to a data 
grouping in a format specified to Record Manager by 
an RT mnemonic parameter in a file information 
table in memory or by a FILE control statement. 
Examples of Record Manager record types are W, in 
which a control word provides record length, and F, 
which is a fixed length record. 

Under KRONOS, NOS and SCOPE 3.4, information 
between beginning-of-information and end-of- 



information is divided into logical records terminated 
by a marker containing a level number. A marker 
containing a level 17 establishes the next smaller 
division between beginning- and end-of-information; 
the level 17 marker is commonly termed an end-of- 
file marker. A record terminated with a level 
marker is smaller than a level 17 record; the level 
marker is commonly termed an end-of-record marker. 
The physical file formats that produce the logical 
end-of-file and end-of-record are the formats internal 
to the operating system (KRONOS and NOS I 
(internal), SI (SCOPE internal), or X (external) tape 
format or mass storage; SCOPE 3.4 mass storage and 
tape SCOPE logical record format). 

Terms logically equivalent among operating systems are: 

SCOPE 2.1 KRONOS, NOS, SCOPE 3.4 



file 


file 


partition 


level 17 record; 




also referred to as a file 


section 


level record; 




also referred to as a record 



m ims manuai, terms irom KRONOS, NOS and 
SCOPE 3.4 are used predominantly. As a result, the 
SCOPE 2.1 end-of-partition becomes an end-of-file 
for the purposes of many discussions, and the 
SCOPE 2.1 section is referred to as a record. 



TYPES AND NAMES OF RECORDS 

The type and the name of a record are determined 
by the COPYL and ITEMIZE utilities from informa- 
tion contained within the record. If the record 
begins with a prefix table, the record name is ob- 
tained from that table and the type of the record is 
determined from the first word following the prefix 
table. If the first word in the record is not a prefix 
table, but is a recognizable format, the format deter- 
mines type. Any record that has neither a prefix 
table nor a recognizable format is classed as a DATA 
type record. 
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PREHX [ABLt Ubb 

Prefix tables exist, unless they have been specifically 
suppressed, for: 

Programs assembled or compiled under any 
operating system 

System text overlays 

KRONOS and NOS user library header records 
and directory records 

MODIFY program library decks, common decks. 
or directory records 

The prefix table is the first of the ordered set of 
binary tables that form object programs. The tables 
consist of a header word with an octal table type 
identifier followed by varying amounts of control 
information that instruct system routines such as the 
loader or that contain the program code. 

The prefix table is identified by octal digits 7700 in 
bits 48-59 of its first word; consequently, it is often 

__r_. i .L_ __ - nn — nne\c\ i^tu T-.r +: — .'— 

icieiiGii iu as ii // oi muu taDie. xiiiujuiiaiiuii 111 

the prefix table, which originates with the assembler 
or other system routine that creates the table, speci- 
fies items such as the date created and the system on 
which the job was executed. 

Although some of the records may contain display 
coded data (loader directives, for instance, are coded), 
they are considered binary records. 



UlHfcK HtUUKU lUtNl IMtrib 

If a prefix table is not present, the first word in a 
record is examined in a search for a recognizable 
format. An UPDATE sequential program library, for 
example, is identified by the characters CHECK in 
the word. 

If a record meets the criteria for a given type of 
record, the utilities identify it as such. For instance, 
a load file beginning with a job card may be identi- 
fied as type COS, TEXT, or DATA, depending on 
the particular characters in the job card. 

Table 1-1 summarizes types of records and the 
criteria used to determine them. 



I 



RECORD NAMES 

If a record begins with a prefix table, bits 18-59 of 
the second word of the table determine the record 
name. If a record does not begin with a prefix 
table, bits 18-59 of the first word of the record are 
used as the record name. 

Records typed as DATA, ACF, UCF, and UPL do 
not have names. 



i 



™. 
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TABLE 1-1. DETERMINING TYPES OF RECORDS 



( 



Type of Record 


Record Description 


Type Determined By 


ABS 


Central processor overlay with one or 
more named entry points 


51 table; or 53 table with bit 17=1 


ACF 


MODIFY compressed compile file 


Second word of 77 table has non-zero in 
bits 00-17 


COS 


Chippewa format central processor pro- 
gram; COMPASS or FORTRAN program 
with errors that suppressed binaries 


No 77 table and first word of record has 
bit 17=0, bit 59=0, and bits 0-16 non-zero 


DATA 


Not any other described record type 


Unrecognizable by criteria defined in these 
tables 


LIBNT 


Library name table record 


SCOPE 3.4 deadstart tape position 


OPL 


MODIFY program library deck 


7001 table with word count 


OPLC 


MODIFY program library common deck 


7002 table with word count 


OPLD 


MODIFY program library directory 


7000 table with word count 


OVL 


Central processor overlay with one 
unnamed entry point (no ENTRY 
statement in program); system text 


50 table; or 53 table with bit 17=0 


PPNT 


Peripheral processor program name table 


SCOPE 3.4 deadstart tape position 


REL 


Relocatable central processor program 


34 table 


SDR 


Special deadstart record 


SCOPE 3.4 deadstart tape position 


TEXT 


Text record such as a KRONOS 
procedure file 


No 77 table and first word has all zeros 
in bits 0-17 


UCF 


UPDATE compressed compile file 


77 table with word count 


ULIB 


KRONOS user library header record 


76 table 


UPLx 


UPDATE sequential program library 
with x master control character 


No 77 table and characters CHECK in bits 
30-59; control character obtained from bits 
0-5 


6PP 


6000 Series peripheral processor overlay 


77 table with three-character name in 
header word 


7PP 


7000 Series peripheral processor overlay 


52 table 
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COPYL/COPYLM: BINARY COPY WITH REPLACEMENT 



( 



COPYL copies an old master file to a new master 
file, substituting records from a replacement file for 
matching records on the old master, and optionally 
adding records to the end of the new master file. 
Records are considered to match if they have the 
same type and name, or optionally, the same name. 
COPYL operates with binary or text records. It is 
commonly used to maintain files of procedures or 
subroutines. 

COPYL and COPYLM differ only in the handling of 
multiple occurrences of a record on the old master. 
COPYL uses each record on the replacement file only 
once, replacing the first matching record from the 
old master file. COPYLM uses the first matching 
record encountered on the replacement file to replace 
each matching record from the old master file. 
COPYL can be used for multiple replacement only if 
multiple copies of the record are on the replacement 
file. 

The master and replacement files must reside on mass 
storage or a binary tape in a format internal to the 
operating system (SCOPE 3.4 format tape for 
SCOPE 3.4; I, SI, or X format for KRONOS and 
NOS; record type S or W for SCOPE 2.1). Only a 
single file terminated by a level 17 record marker 
(SCOPE 2.1 partition) is processed by a single call to 
COPYL or COPYLM. 

Order of records on the replacement file is not 
significant. Records on the new master file are in 
the same order as they were on the old master file. 

COPYL issues dayfile messages (appendix B) during 
processing; no other printed output is produced. 

A field length of 12000 octal is required for execution. 

COPYL replaces only the types of records listed in 
table 2-1. Any record on the old master file that is 
not recognized as one of the listed types is copied to 
the new master file without further processing. 



TABLE 2-1. TYPES''' OF RECORDS REPLACED BY 
COPYL AND COPYLM 



Type 


Description 


A DC 


V^ClLLiai piUl.C!bBUl UVClldJ' W1U1 U11C Ui 




more named entry points 


COS 


Chippewa format central processor 




program; FTN binary with compila- 




tion errors or COMPASS binary with 




assembly errors 


OPL 


MODIFY old program library deck 


OPLC 


MODIFY old program library com- 




mon deck 


OVL 


Central processor overlay with one 




unnamed entry point including 




system texts 


REL 


Relocatable central processor program 


TEXT 


Text record (e.g. KRONOS 




procedure) 


6PP 


6000 Series peripheral processor 




program 


7PP 


7000 Series peripheral processor 




program 


'For adc 


itional information about how these 


types ar 


e determined, consult table 1-1. 



Control statement format: 

COPYL(oldlfn,replfn,newlfn,last,fLag) Single 

replacement 



( 
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COPYLMColdlfn.reDlfn newlfn last f\a"~\ Mulfiils 

replacement 

All parameters are optional and position dependent: 

oldlfn Logical file name of the old master file; 

default name is OLD. 

replfn Logical file name of the replacement 

file; default name is LGO. 

newlfn Logical file name of the updated master 
file; default name is NEW. 

last Name of the last record on oldlfn to 

be processed. If last is not specified, 
all records on oldlfn are processed. 

flag Processing options; default is do not 

select option. 

R Rewind oldlfn and newlfn before 
processing. (Replfn is always re- 
wound before and after processing.^ 

A Append to the end of newlfn all 
replfn records that do not match 
any on the oldlfn. 

T Omit check for matching type of 
record. 

These options can be specified by 
combining one or more letters in any 
order, as TRA, AR, RT, or TR. 



The R option affects master file positioning only 
before processing. If R is specified, both the old 
and new master files are rewound to beginning-of- 
information before processing. In the absence of R, 

the user is responsible for positioning these files. 
After processing, the old master file is positioned 
after the end-of-file (end-of-partition) that stopped 
processing. COPYL writes an end-of-file and does 
not further position the new master file. The R 
option does not affect the file of replacement records, 
since the replacement file always is rewound before 
and after processing. 

The A option causes unmatched records from the 
replacement file to be copied to the new master file 
following the last record copied from the old master 
file. If A is not selected, records on the replacement 
file are ignored and an informative message is issued 
when they do not match records on the existing file. 



Aa4-~-~ 



4-l_„ , 



aim.- i '_-|/m_'ii ViW VWlilUlltS VT11CUIC1 LUC ICI^UIU iliiillC, 

or name and tvoe. will be used to identifv a matchine 
record. If T is not selected, COPYL considers records 
to match only if both the type and name are the 
same. If T is selected, however, COPYL considers 
records to match if they have the same name, re- 
gardless of type. Otherwise, any replacement file 
record that is not of a type listed in table 2-1 is ig- 
nored without comment. 

Records of type COS (such as result from a compila- 
tion or assembly of programs containing errors) are 
handled in a special manner. If a COS type record 
appears on a replacement file, it is always ignored 
without comment. If a COS type record appears on 
the old master file and a record with the same name 
but a type other than COS appears on the replace- 
ment file, the replacement record with the new type 
is always copied to the new master file. The match 
on type is suppressed for COS type records from the 
old master file even when the T option is not speci- 
fied. A COS type record on the old master file that 
is not replaced is copied to the new master file with- 
out change. 

Figure 2-1 shows the dayfile from a job that produces 
four new files (NEW, NEW1, NEW2, and NEW3), using 
the same old master file (OLD) and the same replace- 
ment file (LGO). Figure 2-2 identifies the contents 
of OLD and LGO (figure 2-2a-b) and the newly cre- 
ated files using the ITEMIZE utility. 

Figure 2-3 shows an example of the T parameter of 
COPYL. The old master file (figure 2-3b) contains 
two absolute records named COPYL and ITEMIZE, 
as shown by the execution of the ITEMIZE utility. 
A new relocatable record with the name COPYL is 
created on replacement file XXX (figure 2-3c). Exe- 
cuting the COPYL utility without the T parameter 
produces a new master file, NEW! , that is identical 
to OLD (figure 2-3d). When the T parameter is used, 
records are replaced if the name matches even though 
the type may differ, so that NEW2 (figure 2-3e) is 
not the same as OLD. 

Figure 2-4 shows that the T parameter is not 
required to suppress record type checking when a 
COS type record on the old master file is to be re- 
placed. A COS type record is presumed to be a rec- 
ord with compilation or assembly errors when a 
record with a matching name appears on the replace- 
ment file. A COS type record on the replacement file 
does not suppress the type check, however, and in the 
absence of the T parameter a COS type record cannot 
be written to the new master file. 



C 
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ATTACH OLD.OLDMASTFPFlLE?»TO= 


MO. 




PF CYCLE NO. = Onl 






ITFMIZF(OLO) 






TTFMItE complete. 






MAP, OFF". 






ftn. 






.1?6 CP SFCOMOS COMPILATION TTMF 




ITEMIZF(LGO) 






ITFMI7E COMPLETF. 






REWIND ( OLD «LGO) -* 




— Rewind files. 


COPYL. -* 

UPOATFD — REL / SURA 




—Default file names assumed. 
Only records existing on OLD are 


UPDATED — REL / SURB 




copied to NEW; SUBZ is not on OLD. 


COPYL OID NOT FIND — R'EL / 


SUBZ 




COPYL COMPLETE. 




Only first record named SUBB is replaced. 


ITFMIZF(NFW) 






ITEMIZE COMPLETF. 






COPYL (OLD. LOO » NFW 1«* RA ) -*-- 




-R rewinds 0ID.NEW1. 


UPDATFD — REL / SUra 




A causes records on LGO to be 


UPDATED -- REL / SURR 




added to NEW1 if they did not replace 


APPFNDFO — REL / SUrZ 




records on OLD. 


COPYL COMPLETF. 






I TFM I ZF (NEW] ) 






ITFMI 7E COMPLFTF. 






COPYLM ( OLD »l 00 * MFW? . SURD * P )-*_ 




- SUBD will be last record processed on 


(IDOAT^D — RFL / SURA 




OLD, effectively deleting any records after 


UNDATED — «FL / SURR 




SUBD, including third SUBB record. 


U D nATr0 — REL / SURR 




COPYLM replaces two records named SUBB. 


COPYL niO NOT FIND — PFL / 


SURZ 




COPYL COMPLETF, 






ITFMIZF(MF«»?) 






ITFMI7E COMPLETE. 




/"WTrt/'T » * i _ii _f j 


UPDATED — REL / SURA 




*■" V--»-*A JL J— (i>± lCUlaUva all UWwLU 1 CllUCd \JX 1CI»U1U 

SUBB. 


UPOATFD — REL / SURB 






U°DATFD -- PEL / SURR 






UPRATED — REL / SURR 






CO°YL OID NOT FIND — PEL / 


^UBZ 




COPYL COMPLETE. 






ITEMIZE (NF»n> 






ITEMIZE rO^.PLFTF. 







(. 



Figure 2-1. COPYL and COPYLM Dayfile Example Using R and A Parameters 
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a. Contents of Old Master File OLD. 



b. Contents of Replacement File LGO. 





ITEMIZE 


OF OLO 




FILE 


1 




ITEMIZE 


OF LOO 


FILE 


1 


REC 


NAMF 


TYPE 


LENGTH 


CKSU* 


REC 


NAME 


TY^E 


LENGTH 


CKSiJv 


1 


SU8A 


RFL 




50 


3703 


1 


SUBZ 


RFL 


35 


2312 


2 


SUSP 


REL 




34 


0727 


2 


SUBB 


RFL 


to 


26 4 J 


3 


SU8C 


REL 




37 


5657 


3 


SUB* 


REL 


3? 


143= 


4 


sgee 


REL 




34 


0727 


4 


« EOF » 


SUM = 


127 




5 


sueo 


RFL 




40 


63?n 












6 


SUBS 


REL 




34 


07?7 




d. Contents of NEW1 produced by: 
COPYL(OID,LGO,NEWl B RA) 






» EOI » 


SUM = 




?73 




REC 


ITEMIZE 
NAMF 


OF NEwl 

TYPE 


FlLf- 
L L Nr,TM 


] 
C'KSUm 




c. Contents of NEW Produced by 


COPYL. 


1 


SilBA 


RFL 


1? 


1 435 


REC 


ITFMIZF 
NAMF 


OF NEW 
Tvpf 


FILE 
LFN6TH 


1 
CKSUM 


2 


SUBB 


RFL 


^0 


2643 


1 


SUB A 


*FL 




3? 


1435 


3 


SUBC 


RFL 


3 7 


5*57 


? 


sues 


RFL 




40 


2643 


4 


SUBB 


RFL 


14 


0727 


3 


SUBC 


RFL 




37 


5657 


5 


SUBD 


REL 


U* 


6320 


4 


SUBB 


RFL 




34 


0727 


6 


SUBB 


RFL 


34 


0727 


5 


SUBD 


RFL 




40 


632 


7 


SUBZ 


REL 


3«=i 


2312 


6 


SUBB 


REL 




34 


0727 


a 


* EOF » 


SUM = 


31*. 





• EOF » 



SUM 



261 



e. Contents of NEW2 produced by: 
COPYLM(01D,LGO,NEW2,SUBD ) R) 



ITEMIZE OF NEW? 



f. Contents of NEW3 produced by: 
COPYLM(„NEW3„R) 



ITEMIZE OF NEW .3 



REC 


NAUE 


TYPE 


1 


SUB A 


REL 


7 


SUBB 


RFL 


3 


SUBC 


REL 


4 


SUBB 


REL 


5 


SUBD 


REL 


6 


• EOE » 





PILE 
TH 


1 
CKSUM 


REC 

1 


NAMF 
SUB A 


TYPE 
REL 


32 


1435 


2 


SUBB 


REL 


40 


2643 


3 


SUBC 


PEL 


37 


5657 


4 


SUBB 


REL 


40 


2643 


5 


SUBD 


RFL 


40 


6320 


6 


SUBB 


R p L 



FILE 
LENGTH 


r 

CKSU" 


32 


1435 


40 


264? 


37 


b657 


4* 


2641 


4 


632* 1 


ift 


26a 3 



SUM 



231 



EOF 



SUM = 



271 



Figure 2-2. Contents of Files from Figure 2-1 



2-A 
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a. Dayfile from job. 



ATTACH (LIB, UF0LIB,I0=FT) 
PF CYCLE NO. = 010 
C0PY8R(LI3,0LC,2) 
REWIN0(LI3) 
LIBRARY(LI3> 
FTN<B=XXX,L=0)-« 



.0*0 CP SECONDS COMPILATION TIME 
ITEMIZE (CLD> 

ITEMIZE COMPLETE. 
ITEMIZE(XXX) 

ITEMIZE COMPLETE. 
COPYL fOLD,X XX, NEW1) 
COPYL OID NOT FIND — REL / COPYL-*— 

COPYL COMPLETE. 
ITEMIZE OIEWI) 

ITEMIZE COMPLETE. 
COPYL(OLO,XXX,NcW2 t ,*T>-« 

UPOATEO ■-- ABS / COFYL 

COPYL COMPLETE. 
ITEMIZE C NEW 2 > 

ITEMIZE COMPLETE. 



b. Contents of OLD. 



REC 


ITEMIZE 

NAME 


OF OLD 
TYPE 


FILE 
LENGTH 


1 
CKSUM 


1 


ITEMIZE 


ASS 


1737 


20 <»6 


2 


ITEMIZE 
COPYL 

COPYL 
COPYLM 


ASS 


U3«t 


1350 




♦ EOI * 


SUM = 


3073 





d. Contents of NEW1 produced by: 
COPYL(OLD ) XXX,NEWl) 



-Program COPYL on INPUT file is relocatable, so type 
REL shows on file XXX itemize. 



-Record on XXX that does not match name and type on 
OLD is reported on dayfile. Type indicated is from 
replacement file. 

• With T parameter, only the name needs to match. 
Updated record type is type from old master. 



c. Contents of XXX. 



ITEMIZE OF XXX 
REC NAME TYPE 



COPYL 



* EOF * 



REL 



SUM = 



'Type differs 
from OLD 



33 



e. Contents of NEW2 produced by: 
COPYL(OLD ,XXX,NEW2 „RT) 



REC 


ITFMIZE 
NAME 


OF NEH1 
TYPE 


"ILE 

l£ngth 


1 
C<SUM 


.REC 


ITEMIZE 
NAME 


OF NEH2 
TYPE 


FILE 
LENGTH 


. 1 
CKSU.1 


1 


ITEMIZE 


A3S 


1737 


2D<.6 


1 


ITEMIZE 


A3S 


1737 


2G<»6 


2 


ITEMIZE 
COPYL 


ABS 


11^» 


1350 


2 


ITEMIZE 
COPYL 


REL 


33 


54 26 




COPYL 
COPYLM 








3 


♦ EOF » 


SUM = 


1772 





EOF 



SUM 



3C73 



( 



Figure 2-3. COPYL Example Showing Use of T Parameter 
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a. Day file from job. 



r?i»l -/mtm 



TN 

1M17 
»7L"T 



I3N 



113«»» 
a TLA* 



T3>1 



C »"NCL=0 ( B=OLD« -« 

COMPILING fESTi 

TESTi - .05B ? r r 

COMPILING TEST2 

1 FCr» T *»H ^"ops 

TE3T2 - .013 **C 

CDlPILT?» r ' T£?T3 

FEST3 - .051 * C C 

.126 r.p «TroNn« co M 

FINtL-0»B=BIN,8L) -* 

COMPILING TEST2 
TEST? - .Ofc«i *Fr 

i3«»B 5" ^EC^OS C3M 
ITEMIZE(OLOI 
.ITEMIZE COMPLETE. 
ITEHI7E(6IH' 

ITEpI7£ COUPLET. 
COPY.r0U>,BIN,NEM) 
UPDATED — CIS f IEST* 
20P*L COM^LFTc. 
ir erk tT7E(MFW) 

It E mI7E C 1 T" > U^TE. 
ITM(W. t U=fl,B=UPO> 
C31PIL T N<; T<i<JTT 

1 Pn'TRftM ERRORS 
TE3M - .055 «C 

.337 ^° "-ECOMOS C01 
COPtl iNcW,Uf 0> 'i£Kflf »i*> 
COPYL COUPLETS. 
ITEHTZEfNEWft) 

TTENIZ C C01OLETE. 



b. Contents of old master file OLD. 



TM 

TJHC 






re: 



ITEMIZE "F OLD 
H»HE TYPE 

i T|«!T1 PEL 

9 TEST2 COS 

3 TEST3 REL 



fTLE 1 

LENGTH CKSUH 

37 233? 

J *«>3? 

6i bill 



• EOF • SUM = t»7 

d. Contents of new master file NEW. 



Compile 3 subroutines on file OLD. 
Error in TEST2 results in type COS. 



Compile replacement for TEST2 on file BIN. 
No errors result in type REL record. 




-Type REL replaces type COS on OLD even 
without T parameter. 



Compile replacement for TEST3. Errors result 
in type COS for replacement file UPD. 



COS type record on UPD is ignored if no T 
parameter. 



c. Contents of replacement file BIN. 



ITEMIZE OF BIN 
REC N«*E TYPE 



f TLg 1 

LENGTH CKSUM 



TEST2 



• EOF • 



REL 



SUM = 



« 



43 



<»3?6 



e. Contents of new master file NEWA. 



Sec 


ITFHT7E 

N6KE 


OF MEK 
TYPE 


LtN 


FTLE 
GTH 


1 
v*C5W 


REC 


TTE1T7E 
!«RE 


OF NEWA 

| 1 • & 


FILE 
LEVGTM 


1 


1 


TEStl 


REL 




*7 


?33< 


1 


TiSTt 


REL 




77 


2375 


2 


TEST2 


REL 




««3 


*326 


2 


T-ST2 


REL 




••3 


t»3?6 


3 


TEST3 


REL 




65 


Mil 


3 


TESTJ 


REL 




65 


hi 11 



EOF 



SUM = 



167 



EOF 



SUM = 



167 



Figure 2-4. COPYL bxample Showing CUS iype Kecord Handling 
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ITEMIZE: LIST CONTENTS OF BINARY FILE 



ITEMIZE lists pertinent information about each record 
of a binary file in a format suitable for printing. 
Table 3-1 describes the types of records processed by 
ITEMIZE. 

ITEMIZE processes mass storage files or tape files in 
a format internal to the operating system (SCOPE 
format for SCOPE 3.4; I, SI, or X format for 
KRONOS and NOS; record type S or W for 
SCOPE 2.1). A file can be processed from 
beginning-of-information through end-of-information. 

Output from ITEMIZE is affected by the type of 
record and options selected. A header appears for 
each file terminated by an end-of-file marker 
(SCOPE 2.1 end-of-partition) within the file speci- 
fied by logical file name. The first line of the header 



identifies the logical file name, file position within 
that file, and the date and time of the run. The 
second line of the header has the following fields: 



REC 



NAME 



TYPE 



LENGTH 



Position of record starting with 
1 for each file. 

Record name obtained from the 
second word of the prefix table 
or from the first word of the 
record. 

Type of record as shown in 
table 3-1. 

Number of words (octal) in the 
record, excluding the prefix 
table. 



lABLb. 3-1. TYPES Oh RECORDS LISTED BY ITEMIZE 



t 



Type of Record 



ABS 

ACF 
COS 

DATA 
LIBNT 

OPL 
OPLC 
OPLD 

OVL 



Record Description 



Central processor overlay with one or 
more named entry points 

MODIFY compressed compile file 

Chippewa format central processor pro- 
gram; COMPASS or FORTRAN program 
with errors that suppressed binaries 

Not any other described record type 

Library name table record 

MODIFY program library deck 

MODIFY program library common deck 

MODIFY program library directory 

Central processor overlay with one 
unnamed entry point (no ENTRY 
statement in program); system text 



Type of Record 



PPNT 
REL 
SDR 

TEXT 

UCF 
ULIB 
UPLx 

6PP 
7PP 



Record Description 



Peripheral processor program name table 

Relocatable central processor program 

Special deadstart record 

Text record such as a KRONOS 
procedure file 

UPDATE compressed compile file 

KRONOS user library header record 

UPDATE sequential program library 
with x master control character 

6000 Series peripheral processor overlay 

7000 Series peripheral processor overlay 
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CKSIJM 



DATE 



CVclic logical checksum (nc.iaW 

. ^ v ...... v . / , 

excluding the prefix table. 

Date record was created, as 
stored in the prefix table. 



r« r>r\ t-i 



■A \ 



COMMENTS Contents of prefix table. 

If no prefix table is present, associated fields are blank. 

Additional information listed depends on the type of 
record: 



ABS 
DATA 

OPL, OPLC, UPL 

OVL 

TEXT 



6PP 



7PP 



Entry point names are listed. 

First line of record is listed if 
the name of the record is 
OVERLAY. 

Deck names are listed. 

Overlay level is listed in octal. 

Entire record is listed if the 
name of the record is CMRDC, 
IPRDECK, IPRDC, LIBDECK, 
LIBDC, or COMMENT. 

Information stored by EDITLIB 
is listed giving the octal equiva- 
lent of the load address, residence, 
and control card call flag. 

PP number is listed. 



The E option can select further details about several 
types of records. 

The last record in each file is the end-of-file marker, 
which appears on the listing as the characters * EOF *. 
The SUM= identification is the total length for all 
records in the file, including prefix table lengths. 

Any zero length record in the file appears with the 
record name ^Q0\ When it is encountered a sum of 
the lengths of the records encountered since the be- 
ginning of the file, or since the last sum was taken, 
is listed on the output. The length includes prefix 
tables. Record numbering is not restarted until a new 
file is encountered. 



SCOPE 3.4 deadstart tapes can be recognized by 
ITEMIZE. (Deadstart tapes for the other operating 
systems do not need special processing since prefix 



tables exist at the start of each 
SCOPE 3.4 deadstart tapes, ITEMIZE lists deadstart 
records or the library name tables according to their 
positions on the tape. The remaining records are 
listed as usual, with the library name becoming part 
of the header for each file. 

A field length of 12000 octal is required for 
ITEMIZE execution. 

A dayfile message is issued when ITEMIZE completes 
execution. 

Control statement format: 

ITEMIZE(lfn,pl,p2,...pn) 

The first parameter is positional; if omitted, its 
position must be indicated by a comma. All other 
parameters are optional and order independent. 

Ifn Logical file name of binary file to be 

itemized; default name is LGO. 

L=listlfn list output on file listlfn; default is 

L=OUTPUT. 

BL Burstable listing; each file output 

starts at the top of a page. Default 
is a compact listing in which a page 
eject occurs only when the current 
page is nearly full. 

PD Print densely at eight lines per inch; 

default is 6 lines per inch. If this 
parameter is to produce desired re- 
sults, the programmer must ensure 
that output appears at a printer with 
eight-lines-per-inch capability. 

NR No rewind of lfn before or after 

processing; default is rewind before 
and after processing. 

N Itemize until end-of-information is 

reached. 

N=n Itemize n files, where n is a decimal 

integer; default is N=l. 

N=0 Itemize until an empty file is processed. 

E Expand output to list further 

information; default is no expansion. 
For type REL, list entry points. 
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For types OPL and OPLC, list 
modification set names and their 
YANK status. 

For type UPL, list correction 
identifier names. 

Itemize all records within ULIB type 
records; default is list only the user 
library directory. 



If both E and U are selected for ULIB type records, 
all records in the library will be itemized; since the 
records are all type REL, their entry points will be 
listed. 

SCOPE user libraries do not appear as a separate type. 
When they are processed by ITEMIZE, each record is 
identified by its type according to table 3-1 categories. 



Figure 3-1 shows an example of ITEMIZE output 
from a KRONOS deadstart tape. The ITEMIZE call 
was: ITEMIZE(,E,N). 



Figure 3-2 shows the results of two ITEMIZE calls; 
the first listing shows output from the U parameter 
that requests record information from all records in 
library; the second listing shows output from use of 
both the U parameter and E parameter that requests 
entry points for REL type records. 



Figure 3-3 shows ITEMIZE output from a SCOPE 3.4 
deadstart tape. Figure 3-4 shows ITEMIZE output 
from a sequential UPDATE old program library. 



( 
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ITEMIZE OF LGO 
REC NAME TYPE 



1 PRL 

2 2PR 



13 CMfcOECK 



221 
222 



223 
224 



719 

1014 



coot 

P FILES 

APPEND 
ATTACH 

SAVE 

REL* 

SOM= 

PFA5TC1 

PFCAT1 



SYS.IO 
SYSNISC 



FILE 1 

LENGTH CKSUM 



DATE 702/06. 12.25-58. 



6PP <6726) 


160 


2771 


74/09/* 
73/0^ 


6PP (6606) 


50 


4064 


74' 



-Table information for type 6PP 



114 



7122 



TEXT 

CMROECK 

NAME=640B S/M 127i. K*OMOS/NOS INTEGRATION. 

VERSION=KRON3S 2.S1-7-/386C 

NCP=27. 

EQ0 = D8tOM f l,a,0. -* Record contents listed for TEXT when 

name is CMRDECK 



SUM = 



ABS 



54011- 
1052 



-Zero length record forr.es total l&noth 



7113 



74/0.9/' 
73/* r 



I 



-Entry points for type ABS always appear 



OVL 01,00 
0VL 01,00 



2130 
3752 

s Overlay level 



7300 
%222 



74/ a° 
73/ 

7 



ULIB 
ULIB 



12770 
41 



7307 
3725 



"Only directory listed if U parameter omitted 



Figure 3-1. ITEMIZE Example of Records on KRONOS Deadstart Tape 



I 
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RE< 



1 

2 
3 

k 
5 



a. U parameter itemizes records in library. 



ITEMIZE OP ULI3 
NAME TYPE 



ULIB 

LIBREC1 
LIBREC2 
LIBREC3 
ULIB 



EOF 




FILE 


1 




LENGTH 


CKSUM 




12 


6367 


75/, 


17 
2k- 
31 
11 


6013 
3711 
6166 
0535 


75/Gc 
75/32, 
75/32/. 
75/i2/l 



Records within ULIB listed individually 



b. E parameter lists entry points of 
records listed through U option. 





1TEMI7E 


OF ULI3 


FTLE 


1 




c 


NAME 


TYPE 


LENGTH 


CKSUM 




1 


ULIB 


ULIB 


1£ 


6367 


75/, 


2 
3 
h 
5 


LIBPECl 
LIBREC2 
LIBREC3 
ULIB 


REL 

RECl^Pl, 
REL k 

REL x 
REC3EP1 

OPLO 


17 

REC2EP2 
\ 31 

\ReG3EP2 

\ U 


6J13 
3711 

S166 
REC3EP3 
Q535 


75/3 
75/w2 
7 5/2 2/ 
75/02/1. 


6 


* EOF * 


SUM - 


A 117 







•Entry points within records listed if type is REL 



( 



Figure 3-2. ITEMIZE Example Using U and E Parameters 
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EC 


ITEMI*t 
NAME 


OF LGO 
TYPE 


FILE 
LtNSTH 


1 

CKSUM 


1 
2 


CEA 
CES 


6PP (0020) 
6PP (0020) 


6 
437 


5»55 
2156 


22 

23 


CMRDEO 
CMROEC* 


SDR 
SDR 


24614 
30261 


3764 
7501 



REC 

i 
2 



DATE COMMENTS 



SCOPE 3.4 SN1 
SCOPE 3.4 SN74-108 



"Special deadstart record 



46 


DSO 6PP (0006) 


1446 


1641 




47 


SCOPE 3.* LIBNT 


106 


0530 


LIBRARIES 


48 


SCOPE 3«4 PPNT 


1564 


3363 





c 



490 900 6pP(Jbll) 

491 * EOF * SUM s 



ITEMIZE OF LGO 
NAME TYPE 



HUCUUN " 



TEXT 



orary aiiu piugiaii 

3 


I name utuica 

2735 H/21/74 02.23.13. 


675622 




X 


Level 17 file terminator summary 


FILE 
LENGTH 


2 LIBRARY ^NUCLEUS 
CKSUM DATEX COMMENTS 


372 
1657 


4134 / 




-<HJbrary name of 
following records 



Figure 3-3. ITEMIZE Example of SCOPE 3.4 Peartetart Tape 



i 
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ntrol character 


on OLDPL 






la \Aj 




ITEHIZE 


OF NEWPL 


X FILE 1 








REC NAME 


TYPE y 


LENGTH 


CKSUH 


OATE 






1 CHECK U 


UPL» 


311503 


5657 








SDRRE^vr 


roN in^NTS 


LISTED IMfl?n-R OF INSERTION. 








UPDATE 


SC30007 


SC3001i> 


SC300«»5 


SC300i»6 


3C300W 




SC30059 


SC30O6O 


SC3C067 


SC30068 


PTR0075 


ACT30053 




SC30110 


SC30131 


SC30139 


SC30169 


SC30207 


SC3a213 




SC30282 


SC30330 


SC30<«1»3 


SC30512 


SC30513 


PTR2111, 




SC30602 


SC30566 


FTRi»299 


SC30610 


NCNEh 


SC30532 


8-lines 


SC3Q685 


SC30695 


S.C3069 7 


SC30<«87 


SC3Q€96 


SC30722 


SC30e86 


SC30892 


SC30922 


SC3C85S 


SC30<.8o 


SC30501 


per inch 


SC30696A 


SC30736 


SC31031 


SC312Q9 


SC31291 


SC30579 


SC3G883 


<;r.3itQ7 


SC313h0 


SC31 37? 


SC30 c 90 


cr^i 32ii 


listing 


SC31330 


SC31365 


SC31557 


SC31575 


SCI.0125A 


SC3055'* 




SC3Q77*»A 


SC31016 


SC31606 


VER2Q 


SC<tO<i32 


SC317' y 




UPQ0002 


LPO0006 


UP00007 


U«»D0009 


UPO0033 


UPCO' /i 




UPOC029 


liPC0O«,5 


OPO0017 


UPC0 0-2Q 


UPD0C27 


UPP ^' 




UP0006S 


UPD0080 


UPOQ031 


UPC0039 


LPO0C82 


ur 




UP00091 


IPCOfm 


UPDO 01*. 


UPD0C7 8 


liPn0 08 7 






HISTCRY 


UPCQQ11 


UPD0013 


UPC0G61 


LPD0Q63 






L383 


UP00025 


UPO0050 


UPGQQ&2 


UP0QG9i£ 






UP00113 


UPO0117 


SSUL1C 


COMAREG 


C0HA7ir 






COMCCOO 


CCWCDAT 

cokcses 


COHCDXB 


COMCGFL 


COMCr 






COMCSOH 


COHCSFN 


COHCSRT 


comc 






COMCWTH 


CO^FGFL 


COMFROC 


COMFRIC 


COM 






COMCSRT 


COPYL 


ITEHIZE 


L390 


L r 






UPC 01 16 


UPC0121 


CPDQ128 


UPC0131 






DECK LIST. 














HISTCRY 


COMAREG 


COKA7I0 


COMCCQ r 








CC^CGXB 
COHCSFN 


CCfCGFL 


COMCMVE 
COMCSYS 


CQMCP' 








COMCSRT 


COWv 
COK V^ 








COKFfiDC 


COHFRDW 


COHFRIO 








A ■ t n A IX. 


UPCATE 




\ 






2 » EOF * 


SUM = 


311603 




'Deck names 


listed 












for type UPL records. 



SC3C052 
SC3CG3 4 
P T ? l 7 ' 
SC3C 




Correction 
identifiers 
selected by 
E parameter. 



Figure 3-4. ITEMIZE Example of Sequential UPDATE File Records and Dense Listing 
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STANDARD CHARACTER SETS 



CONTROL DATA operating systems offer the 
following variations of a basic character set: 

CDC 64-character set 
CDC 63 -character set 
ASCII 64-character set 
ASCII 63-character set 

These character sets are listed in table A-l . The set 
in use at a particular installation was specified when 
the operating system was installed. 

Depending on another installation option, the system 
assumes an input deck has been punched either in 



026 or in 029 mode (regardless of the character set 
in use). The user, however, may specify the alternate 
mode by a 26 or 29 punched in columns 79 and 80 
of the job card or any 7/8/9 card. The specified 
mode remains in effect through the end of the job 
unless it is reset by specification of the alternate mode 
on a subsequent 7/8/9 card. 

Under NOS and KRONOS, the alternate mode can be 
specified also by a 26 or 29 punched in columns 79 
and 80 of any 6/7/9 card, as described above for a 
7/8/9 card. In addition, 026 mode can be specified 
by a card with 5/7/9 multipunched in column 1, and 
029 mode can be specified by a card with 5/7/9 multi- 
punched in column 1 and a 9 punched in column 2. 



( 
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LU 
CO 

<r 

LU 

I- 

< 

< 
I 
o 

Q 

cc 
< 

z 
< 

h- 
00 



— 01 

° "2 

CO o 

< o 


cor^cgaiOQQ<u.oocn^ , QoO 

COCOCOCOCMCMCMCMCNCMCMCOCMCM 


LU 
CN 


CO CO Q LO 
CM LO LO CM 


CM 
CM 


LL >— 
LO CM 




CO 
CM 


r- 

CM 


LL o LU g 
CO CO co »r 


CJ 

LO 


LU m 

LO CO 


ASCII 
Punch 
(029) 


CO ■* Lp LO CO £ 

cor-coa> c 9 r ~°P'7°? ? P t ? 2 

CN^t-OCM*-*— CO Q- 

c 


CO 

ob 
6 


CO 
CO 
CN 


<? ™ -CT 

<? °9 °9 co 

CO CM ;- 5 


CO 


t- 
O 

9 r- 
o? 00 

° £ 


■f- 

■t- 
■*- 
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CN 


LO 
CO 


o +- 
p- _^ -i- co 
co 3 t ob T 


CN 
00 
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P^ CO 

co co 


External 
BCD 
Code 


cor~0"-oo^r>-N~^rcocoo 

00«-*-£0*3'LOCNCOr-LOi-CN 


CO 

to 


CO 
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co r^ cn co 

CO r- CO — 
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r- 
co 


in 

LO 
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CD 1** 
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Hollerith 
Punch 
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? rt "* 9 „ 1 
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CO 
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co co 
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o 
r^ 


i- CN CO "9- 

r- r^ r^ r^ 


LO 
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Graphic 
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DIAGNOSTIC MESSAGES 



B 



Diagnostic messages for the utilities are listed 
alphabetically by their first word. Each message is 
identified with its issuing routine, significance, and 
action to be taken. 



Output code in table B-l is as follows: B for 
B-display, S for system dayfile and J for job 
dayfile. 
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This publication describes the utilities that operate 
under the following operating systems: 

NOS 1 for the CONTROL DATA® CYBER 
170 Models 171, 172, 173, and 174, CYBER 
70 Models 71, 72, 73, 74, and 6000 Series 
Computer Systems. 

NOS/BE 1 for the CDC® CYBER 170, Series 
CYBER 70 Models 71, 72, 73, 74, and 6000 
Series Computer Systems. 

SCOPE 2 for the CONTROL DATA CYBER 
170 Model 176, CYBER 70, Model 76 and 
7600 Computer Systems. 

Publication 



NOS 1 Reference Manual (Volume 1) 
NOS/BE 1 Reference Manual 
SCOPE 2 Reference Manual 



The utilities described are: 

COPYL/ Maintains a single binary file. 
COPYLM (Replaces COPYLM utility under 
SCOPE 2.1.) 

ITEMIZE Lists information about the contents 
of a binary file or multifile. 

The reader is assumed to be familiar with the operating 
system on which the utility is to be run as well as 
CYBER Record Manager or Record Manager features. 

Other utility programs are documented in their respec- 
tive operating system manuals. 

Other documents of interest: 



Publications Number 
60435400 
60493800 
60342600 



CDC manuals can be ordered from Control Data 
Corporation Literature and Distribution Services, 
8001 East Bloomington Freeway, Minneapolis, 
Mn 55420. 

This product is intended for use only as described 
in this document. Control Data cannot be responsible 
for the proper functioning of undescribed features or 
parameters. 
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The terminology used for files and records differs 
somewhat within the different environments of the 
various operating systems. Generally, terms used 
with NOS 1 and NOS/BE 1 are similar; terms used with 
SCOPE 2.1 are different, reflecting SCOPE 2.1 use of 
Record Manager within the operating system. 



The physical representation of files and records 
differs among operating systems and among different 
devices within the same operating system. The logi- 
cal interpretation of physical entities varies less. The 
CYBER utilities recognize logical structures applicable 
to all the operating systems. 

Terms applicable to this manual and the common 
CYBER utilities are discussed below. For a complete 
discussion of possible file formats, consult the refer- 
ence manuals for the respective operating systems. 



FILE STRUCTURE DEFINITIONS 

A file is that collection of information known to an 
operating system by a logical file name. A file begins 
at beginning-of-information and ends at end-of- 
information. No user information exists outside these 
boundaries. 

A division smaller than beginning-of-information to 
end-of-information is known by several different 
names, depending on the operating system. 

Under SCOPE 2.1, information between beginning-of- 
information and end-of-information can be divided 
into partitions which, in turn, can be divided into 
sections. The term record is restricted to a data 
grouping in a format specified to Record Manager by 
an RT mnemonic parameter in a file information 
table in memory or by a FILE control statement. 
Examples of Record Manager record types are W, in 
which a control word provides record length, and F, 
which is a fixed length record. 

Under NOS 1 and NOS/BE 1 , information between 
beginning-of-information and end-of-information is 



divided into logical records terminated by a marker 
containing a level number. A marker containing a 
level 17g establishes the next smaller division between 
beginning- and end-of-information; the level 17g 
marker is commonly termed an end-of-file marker. 
A record terminated with a level marker is smaller 
than a level 17g record; the level marker is com- 
monly termed an end-of-record marker. The 
physical file formats that produce the logical end-of- 
file and end-of-record are the formats internal to the 
operating system (NOS 1 SI (SCOPE internal) or I 
(internal), tape format or mass storage; NOS/BE 1 
mass storage and tape system-logical-record format). 



Terms logically equivalent among operating systems are: 



SCOPE 2.1 


NOS 1, NOS/BE 1 


file 


file 


partition 


level 17g record; 

also referred to as a file 


section 


level record; 

also referred to as a record 



In this manual, terms from NOS 1 and NOS/BE 1 are 
usea preuominantiy. /is a lesun, uic ov^ru, ^.i cim- 
of-partition becomes an end-of-file for the purposes 
of many discussions, and the SCOPE 2.1 section is 
referred to as a record. 



TYPES AND NAMES OF RECORDS 

The type and the name of a record are determined 
by the COPYL and ITEMIZE utilities from informa- 
tion contained within the record. If the record 
begins with a prefix table, the record name is ob- 
tained from that table and the type of the record is 
determined from the first word following the prefix 
table. If the first word in the record is not a prefix 
table, but is a recognizable format, the format deter- 
mines type. Any record that has neither a prefix 
table nor a recognizable format is classed as a DATA 
type record. 
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rncHX iAdLc USE 

Prefix tables exist, unless they have been specifically 
suppressed, for: 

Programs assembled or compiled under any 
operating system 

System text overlays 

NOS 1 user library header records and directory 
records 

MODIFY program library decks, common decks, 
or directory records 

The prefix table is the first of the ordered set of 
binary tables that form object programs. The tables 
consist of a header word with an octal table type 
identifier followed by varying amounts of control 
information that instruct system routines such as the 
loader or that contain the program code. 

The prefix table is identified by octal digits 7700 in 
bits 48-59 of its first word; consequently, it is often 
referred to as a 77 or 7700 table. Information in 
the prefix table, which originates with the assembler 
or other system routine that creates the table, speci- 
fies items such as the date created and the system on 
which the job was executed. 

Although some of the records may contain display 
coded data (loader directives, for instance, are coded), 
they are considered binary records. 



OTHER RECORD iDENTiFiERS 

If a prefix table is not present, the first word in a 
record is examined in a search for a recognizable 
format. An UPDATE sequential program library, for 
example, is identified by the characters CHECK in 
the word. 

If a record meets the criteria for a given type of 
record, the utilities identify it as such. For instance, 
a load file beginning with a job statement may be 
identified as type COS, TEXT, or DATA, depending 
on the particular characters in the job statement. 

Table 1-1 summarizes types of records and the 
criteria used to determine them. 



RECORD NAMES 

If a record begins with a prefix table, bits 18-59 of 
the second word of the table determine the record 
name. If a record does not begin with a prefix 
table, bits 18-59 of the first word of the record are 
used as the record name. 

Records typed as DATA, ACF, UCF, and UPL do 

not have names. 
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COPYL/COPYLM: BINARY COPY WITH REPLACEMENT 
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COPYL copies an old master file to a new master 
file, substituting records from a replacement file for 
matching records on the old master, and optionally 
adding records to the end of the new master file. 
Records are considered to match if they have the 
same type and name, or optionally, the same name. 
COPYL operates with binary or text records. It is 
commonly used to maintain files of procedures or 
subroutines. 

COPYL and COPYLM differ only in the handling of 
multiple occurrences of a record on the old master. 
COPYL uses each record on the replacement file only 
once, replacing the first matching record from the 
old master file. COPYLM uses the first matching 
record encountered on the replacement file to replace 
each matching record from the old master file. 
COPYL can be used for multiple replacement only if 
multiple copies of the record are on the replacement 
file. 

The master and replacement files must reside on mass 
storage or a binary tape in a format internal to the 
operating system (system-logical-record format tape 
for NOS/BE 1 ; I or SI format for NOS 1 ; record 
type S or W for SCOPE 2.1). Only a single file ter- 
minated by a level 17g record marker (SCOPE 2.1 
partition) is processed by a single call to COPYL or 
COPYLM. 

Order of records on the replacement file is not 
significant. Records on the new master file are in 
the same order as they were on the old master file. 

COPYL issues dayfile messages (appendix B) during 
processing; no other printed output is produced. 

A field length of 12000 octal is required for execution. 

COPYL replaces only the types of records listed in 
table 2-1. Any record on the old master file that, is 
not recognized as one of the listed types is copied to 
the new master file without further processing. 



TABLE 2-1. TYPES" 1 " OF RECORDS REPLACED BY 
COPYL AND COPYLM 



Type 


Description 


ABS 


Central processor overlay with one or 




more nameu entry points 


CAP 


Capsule 


COS 


Chippewa format central processor 




program, FORTRAN binary with 




compilation errors or COMPASS 




binary with assembly errors 


OPL 


MODIFY old program library deck 


OPLC 


MODIFY old program library com- 




mon deck 


OVL 


Central processor overlay with one 




unnamed entry point including 




system texts 


PROC 


CYBER CONTROL LANGUAGE 




procedure file 


REL 


Relocatable central processor program 


TEXT 


T**vt rA/>nrH (a n \Tf"lC 1 mnndiliipa'k 


6PP 


6000 Series peripheral processor 




program 


7PP 


7000 Series peripheral processor 




program 


'For additional information about how these 


types ar 


e determined, consult table 1-1. 



Control statement format: 

COPYL(oldlfn,replfn,newlfn,last,flag) Single 

replacement 
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COPYLM(oldlfn,replfn,newlfnJast,flag) Multiple 

„„i.. „.,„„„. 

All parameters are optional and position dependent: 

oldlfn Logical file name of the old master file; 

default name is OLD. 

replfn Logical file name of the replacement 

file; default name is LGO. 

newlfn Logical file name of the updated master 
file; default name is NEW. 

last Name of the last record on oldlfn to 

be processed. If last is not specified, 
all records on oldlfn are processed. 

flag Processing options; default is do not 

select option. 

R Rewind oldlfn and newlfn before 
processing. (Replfn is always re- 
wound before and after processing.) 

A Append to the end of newlfn all 
replfn records that do not match 
any on the oldlfn. 

T Omit check for matching type of 
record. 

These options can be specified by 
combining one or more letters in any 
order, as TRA, AR, RT, or TR. 



The R option affects master file positioning only 
before 'processing. If R is specified, both the old 
and new master files are rewound to beginning-of- 
information before processing. In the absence of R, 
the user is responsible for positioning these files. 
After processing, the old master file is positioned 
after the end-of-file (end-of-partition) that stopped 
processing. COPYL writes an end-of-file and does 
not further position the new master file. The R 
option does not affect the file of replacement records, 
since the replacement file always is rewound before 
and after processing. 



The A option causes unmatched records from the 
replacement file to be copied to the new master file 
following the last record copied from the old master 
file. If A is not selected, records on the replacement 
file are ignored and an informative message is issued 
when they do not match records on the existing file. 



The T option determines whether the record name, 
{\r fiafvio itid tvtse will be used to identify a matching 
record. If T is not selected, COPYL considers records 
to match only if both the type and name are the 
same. If T is selected, however, COPYL considers 
records to match if they have the same name, re- 
gardless of type. Otherwise, any replacement file 
record that is not of a type listed in table 2-1 is ig- 
nored without comment. 

Records of type COS (such as result from a compila- 
tion or assembly of programs containing errors) are 
handled in a special manner. If a COS type record 
appears on a replacement file, it is always ignored 
without comment. If a COS type record appears on 
the old master file and a record with the same name 
but a type other than COS appears on the replace- 
ment file, the replacement record with the new type 
is always copied to the new master file. The match 
on type is suppressed for COS type records from the 
old master file even when the T option is not speci- 
fied. A COS type record on the old master file that 
is not replaced is copied to the new master file with- 
out change. 

Figure 2-1 shows the dayfile from a job that produces 
four new files (NEW, NEW1, NEW2, and NEW3), using 
the same old master file (OLD) and the same replace- 
ment file (LGO). Figure 2-2 identifies the contents 
of OLD and LGO (figure 2-2a-b) and the newly cre- 
ated files using the ITEMIZE utility. 

Figure 2-3 shows an example of the T parameter of 
COPYL. The old master file (figure 2-3b) contains 
two absolute records named COPYL and ITEMIZE, 
as shown by the execution of the ITEMIZE utility. 
A new relocatable record with the name COPYL is 
created on replacement file XXX (figure 2-3c). Exe- 
cuting the COPYL utility without the T parameter 
produces a new master file, NEW1, that is identical 
to OLD (figure 2-3d). When the T parameter is used, 
records are replaced if the name matches even though 
the type may differ, so that NEW2 (figure 2-3e) is 
not the same as OLD. 

Figure 2-4 shows that the T parameter is not 
required to suppress record type checking when a 
COS type record on the old master file is to be re- 
placed. A COS type record is presumed to be a rec- 
ord with compilation or assembly errors when a 
record with a matching name appears on the replace- 
ment file. A COS type record on the replacement file 
does not suppress the type check, however, and in the 
absence of the T parameter a COS type record cannot 
be written to the new master file. 
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ITEMIZE: LIST CONTENTS OF BINARY FILE 
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ITEMIZE lists pertinent information about each record 
of a binary file in a format suitable for printing. 
Table 3-1 describes the types of records processed by 
ITEMIZE. 

ITEMIZE processes mass storage files or tape files in 
a format internal to the operating system (system 
logical-record format for NOS/BE 1; I or SI format 
for NOS 1; record type S or W for SCOPE 2.1). A 
file can be processed from beginning-of-information 
through end-of-information. 

Output from ITEMIZE is affected by the type of 
record and options selected. A header appears for 
each file terminated by an end-of-file marker 
(SCOPE 2.1 end-of-partition) within the file speci- 
fied by logical file name. The first line of the header 



identifies the logical file name, file position within 
that file, and the date and time of the run. The 
second line of the header has the following fields: 



REC 
NAME 

TYPE 
LENGTH 



Position of record starting with 
1 for each file. 

Record name obtained from the 
second word of the prefix table 
or from the first word of the 
record. 

Type of record as shown in 
table 3-1. 

Number of words (octal) in the 
record, excluding the prefix 
table. 



TABLE 3-1. TYPES OF RECORDS LISTED BY ITEMIZE 



Type of Record 


Record Description 


Type of Record 


Record Description 


ABS 
ACF 


Central processor overlay with one or 
more named entry points 

MODIFY compressed compile file 


PPNT 
PROC 


Peripheral processor program name table 

CYBER CONTROL. LANGUAGE 
procedure file 




n ,,i~ 


REL 


Relocatable central processor program 


COS 

DATA 


Chippewa format central processor pro- 
gram; COMPASS or FORTRAN program 
with errors that suppressed binaries 

Not any other descirbed record type 


SDR 
TEXT 


Special deadstart record 

Text record such as a NOS 1 
procedure file 


LIBNT 


Library name table record 


UCF 


UPDATE compressed compile file 


OPL 
OPLC 


MODIFY program library deck 
MODIFY program library common deck 


ULIB 


NOS 1 user library header record 


OPLD 


MODIFY program library directory 


UPLx 


UPDATE sequential program library 
with x master control character 


OVL 


Central processor overlay with one 
unnamed entry point (no ENTRY 
statement in program); system text 


6PP 

7PP 


6000 Series peripheral processor overlay 
7000 Series peripheral processor overlay 
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CKSUM 



DATE 



Cyclic logical checksum (octal), 
excluding the pieiix table. 

Date record was created, as 
stored in the prefix table. 



COMMENTS Contents of prefix table. 

If no prefix table is present, associated fields are blank. 

Additional information listed depends on the type of 
record: 



ABS 
DATA 

OPL, OPLC, UPL 

OVL 

TEXT 



6PP 



7PP 



Entry point names are listed. 

First line of record is listed if 
the name of the record is 
OVERLAY. 

Deck names are listed. 

Overlay level is listed in octal. 

Entire record is listed if the 
name of the record is CMRDC, 
IPRDECK, IPRDC, LIBDECK, 
LIBDC, or COMMENT. 

Information stored by EDITLIB 
is listed giving the octal equiva- 
lent of the load address, residence, 
and control card call flag. 

PP number is listed. 



The E option can select further details about several 
types of records. 

The last record in each file is the end-of-file marker, 
which appears on the listing as the characters * EOF *. 
I The SUM= identification is the total length, in words, 
for all records in the file, including prefix table lengths. 

Any zero length record in the file appears with the 
record name (00). When it is encountered, a sum of 
the lengths of the records encountered since the be- 
ginning of the file, or since the last sum was taken, 
is listed on the output. The length includes prefix 
tables. Record numbering is not restarted until a new 
file is encountered. 

If a record of type UPL has more correction identifier 
names and/or deck names than can be accommodated 
within the ITEMIZE buffer, the following message 
appears on the listing in place of the excess names: 
TRUNCATED - - IDENT OR DECK LIST TOO LONG. 
In this instance, the UPDATE utility must be used to 
obtain a complete list of identifiers and deck names. 



NOS/BE 1 deadstart tapes can be recognized by 
ITEMIZE. (Deadstart rapes for the other operating 

m,r.+o T ^.r. A„ „„+ ~~~A „„,.„:.,1 : „: «.. 

tables exist at the start of each record.) For 
NOS/BE 1 deadstart tapes, ITEMIZE lists deadstart 
records or the library name tables according to their 
positions on the tape. The remaining records are 
listed as usual, with the library name becoming part 
of the header for each file. 

A field length of 20000 octal is required for 
ITEMIZE execution. 

A dayfile message is issued when ITEMIZE completes 
execution. 

Control statement format: 

ITEMIZE(lfn,pl,p2,...pn) 

The first parameter is positional; if omitted, its 
position must be indicated by a comma. All other 
parameters are optional and order independent. 



lfn 



L=iistitn 



BL 



PW 



PW=n 



PD 



Logical file name of binary file to be 
itemized; default name is LGO. 

List output on file listifn; default is 
L=OUTPUT. 

Burstable listing; each file output 
starts at the top of a page. Default 
is a compact listing in which a page 
eject occurs only when the current 
page is nearly full. 

Print width; print 72-character lines 
regardless of the listing file device. 

Print either 136-character lines or 
72-character lines depending on the 
value of n, where n is a decimal 
integer. If n > 136, print 136- 
character lines. If n < 136, print 
72-character lines. 

If PW is omitted, the default value 
is 72-character lines if the listing 
file is a terminal; otherwise, the de- 
fault value is 136-character lines. 

Print densely at eight lines per inch; 
default is 6 lines per inch. If this param- 
eter is to produce desired results, the 
programmer must ensure that output 
appears at a printer with eight-lines-per 
inch capability. 
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a. U parameter itemizes records in library. 



\J 


ITEMIZE 
NME 


OF ULI3 
TYPE 


FILE 
LENGTH 


1 

CKSUN 




1 

2 
3 

5 


ULTB 

LIBREC1 

LIBREC? 

LIBRFC3 

ULIR 


ULIB 

REL) 
REL>>^ 
REL> ^\ 
3 L^ >h 


12 

2!+ 

31 
. 11 


b^F-7 
6013 

7711 
616to 
3s35 


7 r A 

75/Cc 

75/2?. 

75/12/. 

75/-2/1 



* EOP 



SUM = 



117 



Records within ULIB listed individually 



b. E parameter lists entry points of 
records listed through U option. 



ITEMIZE Of ULIB 



NAME 

ULIB 
LIBREC1 

LI8REC2 

LIBREC3 

ULIB 

* EOF * 



TYPf 



FILE 
LENGTH 




CKSUM 

5i«S7 
60 13 

3711 

6166 
REC3EP3 

as 35 



75/, 

73/. 2 
7 5/ "■?/ 
7 5/0 2/1. 



Entry points within records listed if type is REL 



Figure 3-2. ITEMIZE Example Using U and E Parameters 
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?4 
?5 
2* 
27 



496 
497 



PEC 

1 
2 



I? 
13 



ITEMIZE OF TAPE 
rMMF TYPE 



FILE \ 

LENGTH CKSUM 



CEA 

CES 
DDT 



CMROC 
C-MPDC 
CMS DC 
CMROC 



909 

* EOF * 



6PP (0020) 
6=P (0020) 
6°P (0000) 



SOR 
SDR 
SDR 
509 



X 



6 
1274 
1251 



?657^ 
23^5} 
26424 
2460 f 



Special deadstart record 



bPP (6123) 56 
SUM r 751677 



ITEMIZE OF TAPE 
NAME TYPE 



ACCOUNT 



COS 
OATA 



CPCTEXT OVL 01*01 
CPUTEXT OVL 01*01 



5375 
14C? 
320 



1161 
5225 
343 7 
405? 



472? 



** UNLABELED »* 
DATE COMMENTS 



04/21/76 09.0 



N0S/8E 1 

NOS/HE 1 . 1 

NDS/bt. 1.1 

NOS/hE 1.1 



04/21/76 09.06,25. NO 



Level 17g file terminator summary 



FILE ? 
LENGTH CKSUM 



LI9PARY 
DATE 



^NUCLEUS 
COMMENTS 



426 
1736 



6664 
7566 



•Library name of following records 



4534 


3544 


09/21/76 15.42.40. 
SYSTEM TEXT FOR CP' 


4026 


2522 


09/21/76 15.42, 
SYSTEM TEXT FO r 



Figure 3-3. ITEMIZE Example of NOS/BE 1 Deadstart Tape 
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STANDARD CHARACTER SETS 



CONTROL DATA operating systems offer the following 
variations of a basic character set: 

CDC 64-character set 
CDC 63-character set 
ASCII 64-character set 
ASCII 63-character set 



The set in use at a particular installation was specified 
when the operating system was installed. 



Depending on another installation option, the system 
assumes an input deck has y been punched either in 026 
or in 029 mode (regardless of the character set in use). 
Under NOS/BE 1 the alternate mode can be specified by 
a 26 or 29 punched in columns 79 and SO of the job 
statement or any 7/8/9 card. The specified mode 



remains in effect through the end of the job unless it 
is reset by specification of the alternate mode on a sub- 
sequent 7/8/9 card. 



Under NOS 1 , the alternate mode can be specified by 
a 26 or 29 punched in columns 79 and 80 of any 

Iffy L-aiu, aa ucduiucu auuvo iui a //o/> uaiu. in 

addition, 026 mode can be specified by a card with 
5/7/9 multipunched in column 1, and 029 mode can 
be specified by a card with 5/7/9 multipunched in 
column 1 and a 9 punched in column 2. 



Graphic character representation appearing at a termi- 
nal or printer depends on the installation character set 
and the terminal type. Characters shown in the CDC 
Graphic column of the standard character set table 
are applicable to BCD terminals: ASCII graphic char- 
acters are applicable to ASCII-CRT and ASCII-TTY 
terminals. 
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TABLE A-l. STANDARD CHARACTER SETS 



Display 
Code 
(octal) 



00 t 

01 

02 

03 

04 

05 

06 

07 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

50 

51 

52 

53 

54 

55 

56 

57 

60 

61 

62 

63 

64 

65 

66 

67 

70 

71 

72 

73 

74 

75 

76 

77 



CDC 



Graphic 



: (colon)" 
A 
B 
C 
D 
E 
F 
G 
H 
I 

J 
K 
L 
M 
N 

P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 
2 

1 
2 
3 
4 
5 
6 
7 
8 



) 
S 

blank 
, (comma) 
. (period) 



[ 



,tt 



f 

1 
< 
> 
< 
> 

(semicolon) 



Hollerith 
Punch 
(026) 



8-2 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 

11-1 

11-2 

11-3 

11^* 

11-5 

11-6 

11-7 

11-8 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

0-8 

0-9 



1 

2 

3 

4 

5 

6 

7 

8 

9 

12 

11 

11-8-4 

0-1 

0-8-4 

12-8-4 

11-8-3 

8-3 

no punch 

0-8-3 

12-8-3 

0-8-6 

8-7 

0-8-2 

8-6 

8-4 

03-5 

1 1.r> nr 11 q ottf 

03-7 
11-8-5 
11-8-6 
12-0 or 123-2 nt 
11-8-7 
8-5 
12-8-5 
12-8-6 
12-8-7 



External 
BCD 
Code 



00 

61 

62 

63 

64 

65 

66 

67 

70 

71 

41 

42 

43 

44 

45 

46 

47 

50 

51 

22 

23 

24 

25 

26 

27 

30 

31 

12 

01 

02 

03 

04 

05 

06 

07 

10 

11 

60 

40 

54 

21 

34 

74 

53 

13 

20 

33 

73 

36 

17 

32 

16 

14 

35 

CI 
\J4L. 

37 
55 
56 
72 
57 
15 
75 
76 
77 



Graphic 
Subset 



(colon) *t 
A 
B 
C 
D 
E 
F 
G 
H 
I 

J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 

z 



1 

2 
3 
4 
5 
6 
7 
8 
9 
+ 



) 
$ 

blank 

, (comma) 

. (period) 

# 

C 

} 

%" 
" (quote) 
_ (underline) 

& 
' (apostrophe) 

7 

< 

> 

@ 

\ 
- (circumflex) 
; (semicolon) 



t 



Punch 
(029) 



8-2 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 

11-1 

11-2 

11-3 

11-4 

11-5 

11-6 

11-7 

113 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

03 

0-9 



1 

2 

3 

4 

5 

6 

7 

8 

9 

123-6 

11 

113-4 

0-1 

123-5 

113-5 

113-3 

83 

no punch 

033 

123-3 

8-3 

123-2 

113-2 

03-4 

8-7 

03-5 

.. _ttt 

i*-b-i or 1 l-ir ' ' 

12 

8-5 

03-7 

123-4 or 123 tft 

033 

8-4 
03-2 
113-7 
113-6 



Code 
(octal) 



072 

101 

102 

103 

104 

105 

106 

107 

110 

111 

112 

113 

114 

115 

116 

117 

120 

121 

122 

123 

124 

125 

126 

127 

130 

131 

132 

060 

061 

062 

063 

064 

065 

066 

067 

070 

071 

053 

055 

052 

057 

050 

051 

044 

075 

040 

054 

056 

043 

133 

135 

045 

042 

137 

041 

046 

047 

077 

074 

076 

100 

134 

136 

073 



tt 



Twelve zero bits at the end of a 60-bit word in a zero byte record are an end of record mark rather than 

two colons. - 

'In installations using a 63-graphic set, display code 00 has no associated graphic or card code- display 

code 63 is the colon (8-2 punch). The % graphic and related card codes do not exist and translations 
. . yield a blank (55g). 
TTT The alternate Hollerith (026) and ASCII (029) punches are accepted for input only. 
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' I COMMENT SHEET .___ ~^~„_ 

I /3 CV GOMTRpL DATA 

# , Vac/ CORPORATION 

# I TITLE: CYBER Common Utilities Reference Manual 

# I PUBLICATION NO, 60495600 REVISION E 

( 

a 

> 

\ What improvements to this manual do you recommend to better serve your purpose? 

( 
( 
< 



This form is not intended to be used as an order blank. Control Data Corporation solicits your comments about this 
manual with a view to improving its usefulness in later editions. 

Applications for which you use this manual. 



Do you find it adequate for your purpose? 



Note specific errors discovered (please include page number reference). 



General comments: 



FROM NAME: POSITION:. 

COMPANY 

NAME: 



ADDRESS: 



NO POSTAGE STAMP NECESSARY IF MAILED IN U.S.A. 

FOLD ON DOTTED LINES AND STAPLE 



O ! flrLC 



STAPLE 



FOLD 



FOLD 
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MINNEAPOLIS. MINN. 



-\ 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN U.S.A. 
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Publications and Graphics Division 

215MoffettParkDrive 
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